home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / src / exampleCode / opengl / GLUT / README < prev    next >
Text File  |  1996-11-11  |  3KB  |  108 lines
  1.  
  2. This directory and its subdirectories contains the OpenGL Utility
  3. Toolkit (GLUT) distribution.  See the NOTICE for legal terms.
  4.  
  5. VERSION:
  6.  
  7. Release 3.1, May 3, 1996.
  8.  
  9. SUPPORTED MACHINES:
  10.  
  11. This distribution should compile for:
  12.  
  13.   o  DEC Alpha workstation running OSF/1 and OpenVMS with Open3D
  14.      layered product.
  15.  
  16.   o  IBM RS/6000 workstations running AIX with OpenGL support.
  17.  
  18.   o  Metro Link's Metro OpenGL for Linux.
  19.  
  20.   o  SGI workstation running IRIX 5.2 or higher supporting OpenGL,
  21.      including 64-bit and N32 support IRIX 6.1 and 6.2.
  22.  
  23.   o  Template Graphics Software's OpenGL for Sun workstations.
  24.  
  25.   o  Mesa 1.2 (and 1.1) for Unix workstations, including Linux PCs
  26.      and SunOS 4.1.x.
  27.  
  28. MAKEFILE GENERATION TO BUILD GLUT:     <-- IMPORTANT!
  29.  
  30. Use mkmkfiles.sgi to put Makefiles using the SGI Makefile conventions
  31. in place.  Use mkmkfiles.imake to put Makefiles generated from
  32. Imakefiles in place.  Run one of these two commands in this directory,
  33. then do a "make".
  34.  
  35. FREQUENTLY ASKED QUESTIONS ABOUT GLUT:
  36.  
  37. See FAQ.glut
  38.  
  39. CONTENTS OVERVIEW BY DIRECTORY:
  40.  
  41.   GL - GLUT interface header files
  42.  
  43.   lib - source code for GLUT libraries
  44.  
  45.      glut - GLUT library implementation
  46.  
  47.      fglut - GLUT FORTRAN bindings.
  48.  
  49.      glut.n32 - IRIX 6.2 "N32" version of the GLUT library.
  50.  
  51.      fglut.n32 - IRIX 6.2 "N32" version of the GLUT library.
  52.  
  53.      glut.n64 - 64-bit version of the GLUT library.
  54.  
  55.      fglut.n64 - 64-bit version of the GLUT library.
  56.  
  57.   test - test programs for GLUT library
  58.  
  59.   progs - programs using GLUT
  60.  
  61.      examples - misc. GLUT examples
  62.  
  63.      redbook - examples from the OpenGL Programming Guide ported to GLUT
  64.  
  65.      contrib - contributed GLUT examples
  66.  
  67.      demos - more involved OpenGL demos using GLUT
  68.  
  69.      fortran - GLUT FORTRAN examples
  70.  
  71. DOCUMENTATION:
  72.  
  73. See the other README files in this directory.  There is a complete
  74. specification for GLUT API version 3 in PostScript available by
  75. anonymous ftp accompanying this distribution.
  76.  
  77. SHAMELESS BUT HOPEFULLY HELPFUL PLUG:
  78.  
  79. Since November 1994, The X Journal carries a column on OpenGL that I
  80. write.  Each column uses GLUT for the examples.  If you are looking to
  81. learn about OpenGL, this may be a good place.  The X Journal (ISSN
  82. 1056-7003) is published six times per year, bimonthly by SIGS
  83. Publications, 71 West 23rd St, 3rd floor, NY, NY 10010, 212-242-7447.
  84. Subscription rates - one year (six issues) individual:  $39 domestic;
  85. $64 Canada and Mexico; $79 foreign; institutional: $99 domestic; $124
  86. Canada and Mexico; $139 foreign.  Send address changes and subscription
  87. orders to:  The X Journal, PO Box 5050, Brentwood, TN 37024-5050.  For
  88. service on current subscriptions, call 800-361-1279(v); or
  89. 215-785-6073(f); or subscriptions@sigs.com (email).
  90.  
  91. BUG REPORTING:
  92.  
  93. Send bug reports by electronic mail to mjk@sgi.com
  94.  
  95. Questions of a general interest about GLUT will be answered on the
  96. comp.graphics.api.opengl newsgroup.
  97.  
  98. ACKNOWLEDGEMENTS:
  99.  
  100. Much thanks to OpenGL engineers at DEC, IBM, Metro Link, Microsoft, SGI,
  101. Sun, and TGS as well as Brian Paul from the University of Wisconsin for
  102. helping me ensure the portability of this code to non-SGI graphics
  103. platforms.  Also thank you to GLUT users who supplied me with feedback
  104. and bug fixes.
  105.  
  106. - Mark Kilgard
  107.   mjk@sgi.com
  108.